home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / killrq27.zip / KILLRQ.DOC next >
Text File  |  1990-12-05  |  7KB  |  215 lines
  1.  
  2.  
  3.  
  4.  
  5.                         KillRQ v 2.7
  6.  
  7.                  Automated Message Deletion
  8.  
  9.            For QuickBBS and Remote Access Systems
  10.  
  11.               By Jason Steck 1:104/424@FidoNet
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. LICENCE:  KillRQ is released as Freeware as a part of the
  20. FreeNet Project.  KillRQ is free for use so long as it is
  21. used in a manner consistant with applicable laws and network
  22. policies.  The author retains rights to the name "KillRQ"
  23. and to the specific source code used to create this product. 
  24. Reverse-engineering or otherwise modifying the executable
  25. code of this product is a violation of this licence.
  26.  
  27.  
  28.  
  29.                         INTRODUCTION
  30.  
  31.  
  32. KillRQ gives sysops the functionality to control the content
  33. of their messages base.  An unfortunately side-effect of
  34. echomail has been the effect of giving "twits" an open and
  35. widely-distributed forum for the plying of their irritating
  36. art.  As such, many echomail conferences have been, at one
  37. time or another, all but taken over by people and/or threads
  38. which are "twitty".
  39.  
  40. KillRQ is intended to give sysops a fast, efficient method
  41. to automatically delete annoying messages and/or people in
  42. the local message base.  As most networks have prohibitions
  43. on the censorship of in-transit mail, KillRQ restricts its
  44. operation to messages already tossed into the local message
  45. base.  Users of KillRQ are advised that "re-scanning" a
  46. message board, with FastForward (tm) for example, can lead
  47. to a "censored feed" which may be in violation of network
  48. policies.  Accordingly, any such re-scanning should be
  49. executed PRIOR to running KillRQ.
  50.  
  51.  
  52.                     A NOTE ON CENSORSHIP
  53.  
  54.  
  55. The following are some quotes from a newspaper column which
  56. seemed to apply well to the concept of auto-deletion of
  57. echomail:
  58.  
  59. "In political Newspeak, people who are perfectly free to say
  60. whatever they want to nevertheless claim that they are being
  61. 'censored' if other people refuse to pay for their words."
  62.  
  63. "The cry of 'censorship' is raised even against private
  64. individuals and organizations when they don't go along with
  65. things that are said and done by those who demand not only
  66. freedom but also an audience."
  67.  
  68. "'I have a right to say what I want to!' one musician
  69. declared indignantly.  It never seemed to occur to him that
  70. other people also have rights -- including the right not to
  71. touch his stuff.  Once you start talking about rights as if
  72. they override other people's rights, then you are really
  73. talking about privileges."
  74.  
  75.  
  76.  
  77.                         USE OF KILLRQ
  78.  
  79. Killrq uses four "killfiles":
  80.  
  81.     KILLBRD.BBS  --  Auto-delete from certain people on
  82. certain boards.
  83.     KILLALL.BBS  --  Auto-delete from certain people
  84. throughout message base.
  85.     KILLSUBJ.BBS --  Auto-delete all messages with certain
  86. string in subject line.
  87.     KILLTEXT.BBS --  Auto-delete based on strings in
  88. message text throughout message base.
  89.  
  90. These files must be in the same directory as the QuickBBS/RA
  91. message base.  KillRQ must be executed in this directory,
  92. but it may be accessed via the path.  Msgpack.exe, while not
  93. required, is highly recommended.
  94.  
  95. The format of KILLBRD.BBS is:  <board> <Name>
  96.  
  97. For example, the following line would kill all messages from
  98. Doctor Death on board 104:
  99.  
  100. 104 Doctor Death
  101.  
  102.  
  103. The format of KILLALL.BBS is:  <Name>
  104.  
  105. For example, the following line would kill all messages from
  106. Evil Hacker throughout the message base:
  107.  
  108. Evil Hacker
  109.  
  110. The format of KILLSUBJ.BBS is: <Subj>
  111.  
  112. For example, the following line would kill all messages with
  113. "satan" in the subject.
  114.  
  115. Satan
  116.  
  117. Messages would be killed if the search string is ANYWHERE in
  118. the subject line -- even if it is contained in the middle of
  119. a word.  Accordingly, care is advised when choosing search
  120. strings to kill -- if you want to kill a "Sysops are scum"
  121. thread, choosing the word "sysop" in your KILLSUBJ.BBS file
  122. would have the undesired side-effect of killing messages
  123. with a subject line "Sysop meeting" and "Sysop Assistance"
  124. as well.
  125.  
  126. The format of KILLTEXT.BBS is: <Text String>
  127.  
  128. KillRQ will search the message text and kill the message if
  129. any of the text strings listed in KILLTEXT.BBS appear in the
  130. message text.
  131.  
  132. The text search is quite time-consuming as each line of text
  133. must be searched individually.  Therefore, the text search
  134. option is, by default, disabled.  Use the /X command line
  135. parameter to activate the text-killing capability.
  136.  
  137.  
  138.  
  139.                     COMMAND LINE OPTIONS
  140.  
  141. KillRQ may be executed with six command line options.
  142.  
  143.     /P - Full message base pack after message killing.
  144.     /I - Index rebuild after message killing.
  145.     /N - No packing performed.
  146.     /T - Also kill messages TO targets.
  147.     /R - RE: stripping performed.
  148.     /L - Reset LastScan pointer.
  149.     /O - Perform logging of deletions using KILLRQ.LOG.
  150.     /X - Activate text search using KILLTEXT.BBS.
  151.  
  152. There is a design bug in the way QuickBBS treats deleted
  153. messages.  Messages with the deleted flag set will still be
  154. displayed unless an index rebuild or message base packing is
  155. performed after KillRQ sets the deleted flag.  /I is the
  156. default and will be used unless /P or /N are specified on
  157. the command line.  /P should be used if the sysop wishes to
  158. have KillRQ pack and renumber the message base with
  159. Msgpack.exe.  /N should be used, for example, if MsgPack.exe
  160. is not available.  If the /N parameter is used, some message
  161. index rebuilding MUST be accomplished separately or else the
  162. "deleted" messages may be displayed.
  163. KillRQ uses a KILLRQ.CTL file to remember the last message
  164. it scanned to speed scanning in future cases.  If this file
  165. does not exist, it will scan from the beginning of the
  166. message base.
  167.  
  168. When the message base is packed and/or renumbered, this
  169. last-scan pointer MUST be reset to the end of the message
  170. base.  This may be accomplished one of two ways:
  171.  
  172. 1)  Run KillRQ with the /P parameter.  KillRQ will kill
  173. messages AND handle message base packing by invoking
  174. Msgpack.exe.  KillRQ will then reset its own LastScan
  175. pointer.
  176.  
  177. 2)  Run KillRQ with the /N paramter.  Then execute the
  178. message base packer with appropriate options.  Then execute
  179. KillRQ with the /L parameter.  KillRQ will simply set the
  180. LastScan pointer to the end of the newly-packed message
  181. base.
  182.  
  183.  
  184. Use of the /T parameter will allow the COMPLETE auto-
  185. deletion of an annoying individual.  Not only will messages
  186. FROM the people specified be deleted, but messages/replies
  187. TO those people will also be deleted.
  188.  
  189. The /O parameter will cause KillRQ to write each deletion
  190. and a report of the total number of deletions for each run
  191. to a logfile -- Killrq.log.
  192.  
  193. Use of the /R parameter throws an additional "benny" into
  194. KillRQ's operation.  As KillRQ scans each new individual
  195. message, it strips any and all "Re:" sub-strings from the
  196. subject line.  Qlink or other message threading utility can
  197. then be executed accurately.  This functionality in KillRQ
  198. kills any need for another utility and multiple message base
  199. scans.
  200.  
  201.  
  202.              QUESTIONS, ASSISTANCE, BUG REPORTS
  203.  
  204. Bug reports, questions, or requests for assistance should be
  205. directed to Jason Steck at the following addresses:
  206.  
  207. 1:104/424@FidoNet
  208. 200:5000/400@MetroNet
  209. 99:910/952@EggNet
  210. 77:1910/5@LCRNet
  211. 8:7703/10@Network
  212. 11:11/200@OPCN
  213.  
  214.  
  215.